home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / doc / uim-common / DOT-UIM < prev    next >
Encoding:
Text File  |  2005-02-15  |  2.6 KB  |  92 lines
  1. User customization file
  2.  
  3. You can customize uim settings by two alternative ways.
  4.  
  5.   - by uim-pref GUI
  6.   - create the file ~/.uim and write configuration forms by hand
  7.  
  8. This file describes the latter way.
  9.  
  10.  
  11. * Precedence of settings
  12.  
  13.   - The ~/.uim overrides the settings configured by uim-pref. Remove
  14.     conflicting setting from ~/.uim if you prefer setting by GUI
  15.  
  16.   - If ~/.uim does not exist, ${datadir}/uim/default.scm will be
  17.     loaded as default. Since the default.scm is never modified by
  18.     uim, system integrator can modify it as they want.
  19.  
  20.  
  21. * Special settings that cannot be configured in ~/.uim
  22.  
  23.   Overriding following variables in ~/.uim does not take
  24.   effect. Configure them in uim-pref or edit installed-modules.scm
  25.   directly.
  26.  
  27.     enable-lazy-loading?
  28.     enabled-im-list
  29.     installed-im-module-list
  30.  
  31.  
  32. * Overriding lazy-loaded settings
  33.  
  34.   The lazy-loading feature introduced in uim 0.4.6 has caused the
  35.   problem that the entity to be overridden is not loaded at loading
  36.   ~/.uim.
  37.  
  38.   For example, following configuration causes the error because
  39.   japanese.scm is not loaded at loading ~/.uim.
  40.  
  41.   (set! ja-rk-rule-basic (cons '(((" ") . ()) (" " " " " "))
  42.                                ja-rk-rule-basic))
  43.  
  44.   To resolve it, require the file explicitly.
  45.  
  46.   (require "japanese.scm")
  47.  
  48.   (set! ja-rk-rule-basic (cons '(((" ") . ()) (" " " " " "))
  49.                                ja-rk-rule-basic))
  50.  
  51.  
  52.   If you need whole part of an input method, use 'require-module'
  53.   instead of ordinary 'require'. This is required for internal IM
  54.   management.
  55.  
  56.   wrong:
  57.  
  58.     (require "pyload.scm")
  59.     (require "viqr.scm")
  60.     (require "anthy.scm")
  61.     (load-plugin "anthy")
  62.  
  63.   correct:
  64.  
  65.     (require-module "pyload")
  66.     (require-module "viqr")
  67.     (require-module "anthy")
  68.  
  69.  
  70. * Configuring key bindings
  71.  
  72.   To configure key bindings in ~/.uim, write 'define-key' forms. See
  73.   also doc/KEY for further information
  74.  
  75.   Be careful about following two issues.
  76.  
  77.     - Corresponding input method must be loaded by 'require-module'
  78.       before define-key. This implies that define-key described in
  79.       ~/.uim disables lazy-loading for the input method.
  80.  
  81.       (require-module "skk")
  82.       (define-key skk-cancel-key? "<Control>[")
  83.  
  84.     - Meaning of the key expression such as "<Control>a" differs
  85.       between define-key and uim-pref.
  86.  
  87.       "<Control>a" is interpreted as case sensitive and shift
  88.       insensitive by define-key. But uim-pref recognizes it as case
  89.       insensitive and shift sensitive. The different rule of uim-pref
  90.       is introduced to unify "<Control>a" and "<Control>A" regardless
  91.       of caps lock status.
  92.